|
|
PenPat |
||||
| Header: | Quickdraw.h | Carbon status: | Supported | |
Sets the bit pattern to be used by the graphics pen in the current graphics port.
void PenPat (
const Pattern *pat
);
A bit pattern, as defined by a Pattern structure.
The PenPat function sets the graphics pen to use the bit pattern defined in the Pattern structure that you specify in the pat parameter. (The standard patterns white, black, gray, ltGray, and dkGray are predefined; the initial bit pattern for the pen is black.) This pattern is stored in the pnPat field of a GrafPort structure. The QuickDraw painting functions (such as PaintRect) also use the pen’s pattern when drawing a shape.
The PenPat function also sets a bit pattern for the graphics pen in a color graphics port. The PenPat function creates a handle, of type PixPatHandle, for the bit pattern and stores this handle in the pnPixPat field of the CGrafPort structure. This pattern always uses the graphics port’s current foreground and background colors.
To define your own patterns, you typically create pattern, ëPAT’, or pattern list, ëPAT#’, resources.
The PenPat function may move or purge memory blocks in the application heap; do not call this function at interrupt time.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)